Assure you have a reliable backup of the systems in advance of this procedure

Manually Backup Restore Apis configuration

Manually copying Apis Hive configurations

A secure method to copy Apis Hive configuration from one computer to another, or simply have a backup of the configuration, is to copy the configuration files and registry settings. By using this method, copying and restore of configurations can be automated by scripting.

This method also describes various upgrade scenarios.

This method requires basic knowledge to Windows registry settings, how to export and import Windows registry keys.

The configuration location

Current version only support 64-bit, but the 32-bit information is included to suport upgrade to 64-bit.

The procedure varies slightly depending on the bitness (32/64) of the operating system and Apis Foundation. There are mainly 3 configuration storage types; registry, binary files and xml configuration files.

The location of registry Apis configuration

The registry holds information regarding basic functionality of ApisHive, HoneyStore and configuration file location of module configuration.

• The location of registry Apis configuration:
  • HKEY_LOCAL_MACHINE\SOFTWARE\Prediktor
• 32-bit application on 64-bit operating system:
  • HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Prediktor

Apis module configuration files

These files hold information regarding module property, and items, default the file name is the same as the module/database name:

• <ModuleName>.acd Module binary configuration file (old format)
• <ModuleName>.ans Module binary configuration file
• <DatabaseName>.acdb Database binary configuration file (old format)
• <DatabaseName>.ansdb Database binary configuration file

The default location of Apis module configuration:

• <Install Directory>_Config\<INSTANCENAME>_ Module configuration files
• <Install Directory>_Config\ApisHoneyStore_ Database configuration files

Event Historian

If Event Historian (Chronical) is enabled the configuration is stored by default in

• <Install Directory>_Chronical\<INSTANCENAME>_

Apis servers xml configuration files

These files hold information regarding advanced functionality of ApisHive and HoneyStore not found in the registry.

64-bit Apis Foundation:

• <Install Directory>\Bin64
• ApisHiveX64.exe.config
• ApisHiveX64.AppSettings.config
• ApisHoneystoreX64.exe.config
• ApisHoneystoreX64.AppSettings.config

32-bit Apis Foundation:

• <Install Directory>\Bin
• ApisHiveX64.exe.config
• ApisHiveX64.AppSettings.config
• ApisHoneystoreX64.exe.config
• ApisHoneystoreX64.AppSettings.config

Upgrade paths

Copy Apis Hive configuration

1. Copy 32-bit Apis Hive configuration on 32-bit operating system

a. Copy all files from <Install Directory>\Config and if Event Historian (Chronical) is enabled copy all files from <Install Directory>\Chronical\<INSTANCENAME>

b. Copy ApisHive.AppSettings.config and ApisHive.exe.config from <Install Directory>\Bin

c. Export the registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Prediktor\Apis\<INSTANCENAME> to a file.

2. Copy 32-bit Apis Hive configuration on 64-bits-bit operating system

a. Copy all files from <Install Directory>\Config and if Event Historian (Chronical) is enabled copy all files from <Install Directory>\Chronical\<INSTANCENAME>

b. Copy ApisHive.AppSettings.config and ApisHive.exe.config from <Install Directory>\Bin

c. Export the registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Prediktor\Apis\< INSTANCENAME > to a file.

3. Copy 64-bit Apis Hive configuration

a. Copy all files from <Install Directory>\Config and if Event Historian (Chronical) is enabled copy all files from <Install Directory>\Chronical\<INSTANCENAME>

b. Copy ApisHiveX64.AppSettings.config and ApisHiveX64.exe.config from <Install Directory>\Bin64

c. Export the registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Prediktor\Apis\<INSTANCENAME> to a file.

Restore Apis Hive configuration

If the <Install Directory> directory on the destination computer is different from the source computer, the registry settings export file must be changed:

In the exported registry script file, locate where Apis Hive configuration was initially installed the "ApisStorageSource" string value, for instance where system was initially installed in C:\\Program Files (x86)\APIS and is copied/ moved to C:\\Program Files\APIS :

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Prediktor\Apis\ApisHive\Modules\ApisWorker]

@="{983B4AE2-ABB9-11D2-9424-00608CF4C421}"

"ProgIDOfModule"="Prediktor.ApisWorker.1"

"ApisStorageClass"="{4C854C93-C667-11D2-944B-00608CF4C421}"

"ApisStorageSource"=" C:\\Program Files (x86)\APIS\ Config\ApisHive\Worker.ans "

Replace all occurrences of the original location to new location, for instance:

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Prediktor\Apis\ApisHive\Modules\ApisWorker]

@="{983B4AE2-ABB9-11D2-9424-00608CF4C421}"

"ProgIDOfModule"="Prediktor.ApisWorker.1"

"ApisStorageClass"="{4C854C93-C667-11D2-944B-00608CF4C421}"

"ApisStorageSource"="C:\\Program Files\APIS\Config\ApisHive\Worker.ans "

4. Restore 32-bit Apis Hive configuration from 32-bit operating system to 64-bit bits operating system as 64-bit Apis Hive configuration.

a. Install Apis Foundation 64

b. Create new instance if not using default.

c. Copy all files (restore) (1.a.) to <Install Directory>\Config and possibly <Install Directory>\Chronical\<INSTANCENAME>

d. Compare the settings of “ApisHive.AppSettings.config and ApisHive.exe.config” from the 32-bit source system (1.b) with the 64-bit “ApisHiveX64.exe.config and ApisHiveX64.AppSettings.config” on the destination system in <Install Directory>\Bin64. If the settings are different do necessary changes in the 64-bit files.

e. Run registry script. (1.c.)

5. Restore 32-bit Apis Hive configuration from 64-bit operating system to 64-bit bits operating system as 64-bit Apis Hive configuration.

a. Install Apis Foundation 64

b. Create new instance if not using default.

c. Copy all files (restore) (2.a.) to <Install Directory>\Config and possibly <Install Directory>\Chronical\<INSTANCENAME>

d. Compare the settings of “ApisHive.AppSettings.config and“ApisHive.exe.config” from the 32-bit source system (2.b) with the 64-bit “ApisHiveX64.exe.config and ApisHiveX64.AppSettings.config” on the destination system in <Install Directory>\Bin64. If the settings are different do necessary changes in the 64-bit files.

e. Edit the registry script (2.c.)

i. Replace all “SOFTWARE\Wow6432Node\Prediktor” with “SOFTWARE\Prediktor”

ii. Save

f. Run the modified registry script.

6. Restore 64-bit Apis Hive configuration from 64-bit operating system to 64-bit operating system as 64-bit Apis Hive configuration.

a. Install Apis Foundation 64

b. Create new instance if not using default.

c. Copy (restore) all files (3a.) to <Install Directory>\Config, (possibly <Install Directory>\Chronical\<INSTANCENAME>) and the “.config” files (3.b) to <Install Directory>\Bin64

d. Run registry script. (3.c.)

Manually copying Apis Honey Store configuration

Upgrade paths

Copy configuration

1. Copy Apis Honey Store configuration on 32-bit operating system

a. Copy all files from <Install Directory> Config\ApisHoneyStore and.

b. Copy ApisHoneyStore.AppSettings.config, ApisHoneystore.exe.config and ApisOPCHDA.exe.config from <Install Directory>\Bin

c. Export the registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Prediktor\Apis\ApisHoneyStore to a file.

2. Copy Apis Honey Store configuration on 64-bit operating system

a. Copy all files from <Install Directory>\Config\ ApisHoneyStore.

b. Copy ApisHoneyStoreX64.AppSettings.config, ApisHoneystorex64.exe.config and ApisOPCHDAx64.exe.config from <Install Directory>\Bin64

c. Export the registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Prediktor\Apis\ApisHoneyStore to a file.

Restore Apis Honey Store configuration

3. Restore 32-bit Apis Honey Store configuration from 32-bit operating system to 32-bit operating system

a. Install Apis Foundation

b. Copy (restore) all files (1.a.) to <Install Directory>\Config\ApisHoneyStore and the “.config” files (1.b.) to <Install Directory>\Bin

c. Run registry script. (1.c.)

4. Restore 32-bit Apis Honey Store configuration from 32-bit operating system to 64-bit operating system

a. Install Apis Foundation 64

b. Copy (restore) all files (1.a.) to <Install Directory>\Config\ApisHoneyStore

c. Compare the settings of “ApisHoneyStore.AppSettings.config, ApisHoneystore.exe.config and ApisOPCHDA.exe.config” from the 32-bit source system (1.b) with the 64-bit “ApisHoneyStoreX64.AppSettings.config, ApisHoneystorex64.exe.config and ApisOPCHDAx64.exe.config” on the destination system in <Install Directory>\Bin64. If the settings are different do necessary changes in the 64-bit files.

d. Run registry script. (1.c.)

5. Restore 64-bit Apis Honey Store configuration from 64-bit operating system to 64-bit operating system

a. Install Apis Foundation 64

b. Copy (restore) all files (2.a.) to <Install Directory>\Config\ApisHoneyStore and the “.config” files (2.b.) to <Install Directory>\Bin64

c. Run registry script. (2c.)

Manually copy/move Apis Honey Store database

Example user case:

Migration of ApisFoundation to new hardware from Server1 to Server2

Assume we have database named “RedLogger” this is located in C:\\APIS\DBs on Server1

Assume ApisFoundation is installed in same location on both computers C:\\APIS

During migration to Server2 we want to move the location of the “RedLogger” database, to E:\\DBs

• Stop ApisHoneyStore service on Server1 and 2
• Copy C:\\APIS\Config\ApisHoneyStore\RedLogger.ansb from Server1 to C:\\APIS\Config\ApisHoneyStore on Server2
• Copy the RedLogger.dat and RedLogger.cache files from C:\\APIS\DBs on Server1 to E:\\DBs on Server2
• On Server1 export the registry key:
• ”HKEY_LOCAL_MACHINE\SOFTWARE\Prediktor\Apis\ApisHoneyStore\Databases\RedLogger” to a file
• Copy the registry script file to Server2 and run it. (If ApisFoundation is installed in different location than Server1 the “ConfigFile” String Value in the registry script must be altered.)
• Assure you have a backup of the file C:\\APIS\Config\ApisHoneyStore\RedLogger.ansb
• Edit the location of the database in the configuration file, there are two options (tools); offline ApisStructuredStorageViewer and online MMC Snapin:

1. Offline: Start ApisStructuredStorageViewer.exe (is a part of APIS_x_x_x-Tools)

• Open the C:\\APIS\Config\ApisHoneyStore\RedLogger.ansb

• Change the Attrib ID 20 from C:\\APIS\DBs\ to E:\\DBs
• The migration of the database is now finished and ApisHoneyStore can be started on Server2

2. Online: Start ApisHoneyStore service

• From ApisBuddy start ApisHoneyStore MMC snapin
• Navigate to RedLogger database right click and select Administer database…

• In RedLogger properties dialog change DataDirPath from C:\\APIS\DBs\RedLogger.dat\ to E:\\DBs\RedLogger.dat\ and CachePath from C:\\APIS\DBs\ to E:\\DBs

• The migration of the database is now finished